home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / pdselect / awnp / awnp-docs / drawlist.doc < prev    next >
Text File  |  2000-02-16  |  2KB  |  69 lines

  1. DrawList parameters
  2. -------------------
  3.  
  4. The drawlist keyword does not produce a gadget. It creates an image to be used later. Up to 10 images can be predefined, the last one defined is the first one used. Last In First Out.
  5.  
  6. bindata (bd)
  7.  
  8. The drawlistdata will be passed to this pipe in binary after the command line. The drawlistdata parameter now gives the length of the data. Setting datain means the data is read from an external file rather than the pipe.
  9.  
  10. dataout="filename" (do=)
  11.  
  12.  Send the data for this gadget to a file. This is a development tool to allow you to create binary data to pass to the pipe. It is ignored if the Bindata keyword is also present.
  13.  
  14. datain="filename" (di=)
  15.  
  16.  Read the data for this gadget from a file. It is ignored if the Bindata keyword is not present.
  17.  
  18. minheight=number (minh)
  19.  
  20.  Set the height of the virtual raster the drawlist data
  21. relates to.
  22.  
  23. minwidth=number (minw)
  24.  
  25.  Set the width of the virtual raster the drawlist data relates
  26. to.
  27.  
  28. drawlistdata="value1|value2|..."
  29.  
  30.  The draw list data defines a set of drawing instruction to create an image. Each drawing instruction has 6 values.
  31. directive|X1|Y1|X2|Y2|pen
  32.  
  33. The possible directives are
  34.  
  35. 0 END
  36. 1 LINE
  37. 2 RECTANGLE
  38. 3 LINEPATTERN
  39. 4 FILLPATTERN
  40. 5 LINESIZE
  41. 6 AMOVE
  42. 7 ADRAW
  43. 8 AFILL
  44. 9 FILL
  45. 10 ELLIPSE
  46. 11 CIRCLE
  47.  
  48. Register as a Class Act developer and read the docs for more info on drawlists.
  49.  
  50. When sending binary data you send an array of structure DrawLists.
  51.  
  52. struct DrawList
  53.             {
  54.                 WORD dl_Directive;
  55.                 WORD dl_X1, dl_Y1;
  56.                 WORD dl_X2, dl_Y2;
  57.                 WORD dl_Pen;
  58.             };
  59. The last structure MUST be END (dl_Directive=0).
  60.  
  61. Definition Reply
  62. -----------------
  63.  
  64.  When the image creation is successful the pipe replies with
  65.  
  66. 'ok'
  67.  
  68.  
  69.